home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glxmakecontextcurrent.z / glxmakecontextcurrent
Encoding:
Text File  |  2001-04-17  |  8.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt - attach a GLX context to a GLX drawable
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      Bool ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt( Display *_d_p_y,
  14.                                  GLXDrawable _d_r_a_w,
  15.                                  GLXDrawable _r_e_a_d,
  16.                                  GLXContext _g_c )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _d_p_y   Specifies the connection to the X server.
  21.  
  22.      _d_r_a_w  Specifies a GLX drawable that to render into.  Must be an XID
  23.            representing a GLXWindow, GLXPixmap, or GLXPbuffer.
  24.  
  25.      _r_e_a_d  Specifies a GLX drawable that to read from.  Must be an XID
  26.            representing a GLXWindow, GLXPixmap, or GLXPbuffer.
  27.  
  28.      _g_c    Specifies the GLX context to be bound to _r_e_a_d and _g_c.
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt binds _g_c to the current rendering thread and to the
  32.      _d_r_a_w and _r_e_a_d GLX drawables. _d_r_a_w and _r_e_a_d may be the same.
  33.  
  34.      _d_r_a_w is used for all OpenGL operations except:
  35.  
  36.        Any pixel data that are read based on the value of GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR.
  37.        Note that accumulation operations use the value of GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR, but
  38.        are not allowed unless _d_r_a_w is identical to _r_e_a_d.
  39.  
  40.        Any depth values that are retrieved by ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss or ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
  41.  
  42.        Any stencil values that are retrieved by ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss or ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
  43.  
  44.      Frame buffer values are taken from _d_r_a_w.
  45.  
  46.      If the current rendering thread has a current rendering context, that
  47.      context is flushed and replaced by _g_c.
  48.  
  49.      The first time that _g_c is made current, the viewport and scissor
  50.      dimensions are set to the size of the _d_r_a_w drawable.  The viewport and
  51.      scissor are not modified when _g_c is subsequently made current.
  52.  
  53.      To release the current context without assigning a new one, call
  54.      ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt with _d_r_a_w and _r_e_a_d set to NNNNoooonnnneeee and _g_c set to NNNNUUUULLLLLLLL.
  55.  
  56.      ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt returns TTTTrrrruuuueeee if it is successful, FFFFaaaallllsssseeee otherwise.
  57.      If FFFFaaaallllsssseeee is returned, the previously current rendering context and
  58.      drawable (if any) remain unchanged.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEESSSS
  75.      ggggllllXXXXMMMMaaaakkkkeeeeCCCCoooonnnntttteeeexxxxttttCCCCuuuurrrrrrrreeeennnntttt is available only if the GLX version is 1.3 or
  76.      greater.
  77.  
  78.      If the GLX version is 1.1 or 1.0, the GL version must be 1.0.  If the GLX
  79.      version is 1.2, then the GL version must be 1.1.  If the GLX version is
  80.      1.3, then the GL version must be 1.2.
  81.  
  82. EEEERRRRRRRROOOORRRRSSSS
  83.      BBBBaaaaddddMMMMaaaattttcccchhhh is generated if _d_r_a_w and _r_e_a_d are not compatible.
  84.  
  85.      BBBBaaaaddddAAAAcccccccceeeessssssss is generated if _g_c is current to some other thread.
  86.  
  87.      GGGGLLLLXXXXCCCCoooonnnntttteeeexxxxttttSSSSttttaaaatttteeee is generated if there is a current rendering context and
  88.      its render mode is either GGGGLLLL____FFFFEEEEEEEEDDDDBBBBAAAACCCCKKKK or GGGGLLLL____SSSSEEEELLLLEEEECCCCTTTT.
  89.  
  90.      GGGGLLLLXXXXBBBBaaaaddddCCCCoooonnnntttteeeexxxxtttt is generated if _g_c is not a valid GLX rendering context.
  91.  
  92.      GGGGLLLLXXXXBBBBaaaaddddDDDDrrrraaaawwwwaaaabbbblllleeee is generated if _d_r_a_w or _r_e_a_d is not a valid GLX drawable.
  93.  
  94.      GGGGLLLLXXXXBBBBaaaaddddWWWWiiiinnnnddddoooowwww is generated if the underlying X window for either _d_r_a_w or
  95.      _r_e_a_d is no longer valid.
  96.  
  97.      GGGGLLLLXXXXBBBBaaaaddddCCCCuuuurrrrrrrreeeennnnttttDDDDrrrraaaawwwwaaaabbbblllleeee is generated if the previous context of the calling
  98.      thread has unflushed commands, and the previous drawable is no longer
  99.      valid.
  100.  
  101.      BBBBaaaaddddAAAAlllllllloooocccc is generated if the X server does not have enough resources to
  102.      allocate the buffers.
  103.  
  104.      BBBBaaaaddddMMMMaaaattttcccchhhh is generated if:
  105.  
  106.        _d_r_a_w and _r_e_a_d cannot fit into frame buffer memory simultaneously.
  107.  
  108.        _d_r_a_w or _r_e_a_d is a GLXPixmap and _g_c is a direct rendering context.
  109.  
  110.        _d_r_a_w or _r_e_a_d is a GLXPixmap and _g_c was previously bound to a GLXWindow
  111.        or GLXPbuffer.
  112.  
  113.        _d_r_a_w or _r_e_a_d is a GLXWindow or GLXPbuffer and _g_c was previously bound
  114.        to a GLXPixmap.
  115.  
  116.  
  117. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  118.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXCCCCrrrreeeeaaaatttteeeeWWWWiiiinnnnddddoooowwww, ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPiiiixxxxmmmmaaaapppp, ggggllllXXXXCCCCrrrreeeeaaaatttteeeePPPPbbbbuuuuffffffffeeeerrrr,
  119.      ggggllllXXXXDDDDeeeessssttttrrrrooooyyyyCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXGGGGeeeettttCCCCuuuurrrrrrrreeeennnnttttCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXGGGGeeeettttCCCCuuuurrrrrrrreeeennnnttttDDDDiiiissssppppllllaaaayyyy,
  120.      ggggllllXXXXGGGGeeeettttCCCCuuuurrrrrrrreeeennnnttttDDDDrrrraaaawwwwaaaabbbblllleeee, ggggllllXXXXGGGGeeeettttCCCCuuuurrrrrrrreeeennnnttttRRRReeeeaaaaddddDDDDrrrraaaawwwwaaaabbbblllleeee, ggggllllXXXXMMMMaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnntttt
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.